home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / fish / 001-100 / 001-025 / 008 / read_me < prev    next >
Text File  |  1995-03-17  |  4KB  |  87 lines
  1. This disk contains the source to HACK 1.0.1.  Its original source was
  2. placed in the public domain on USENET about a year ago.  I downloaded it
  3. from an APOLLO and converted it to run on the AMIGA.  In the process, I
  4. found several compiler problems (which have been reported to Lattice) and
  5. believe the code to be in a pretty stable state.
  6.  
  7. Known problems: 
  8. 1) When you boot from the standard 1.1 workbench and then run HACK by
  9.    clicking on an ICON, sometimes it sits there for a while (LOADING)
  10.    and then does nothing.  However, the memory that HACK uses up is 
  11.    allocated but the program did not run.  Presumably this is a problem
  12.    in the startup code in 'hack.window.c' but I cannot find it.  Another
  13.    problem may be in the _main.c which is compiled with the TINY flag.
  14.    [This problem now fixed, see changes to "_main.c"  (fnf)]
  15.  
  16. 2) The AMIGADOS command '!' brings up the AmigaDos window and CLI, but
  17.    when you return, it crashes.  This code was listed directly from
  18.    the MuEMACS so I don't believe it is the cause, but then again, who
  19.    knows.  This code is in hack.do.c.
  20.  
  21. 3) Saved game ICONS are deleted by simply deleting the .INFO file.  I do
  22.    not believe this is the right way, but the documentation is not too
  23.    clear as to how to delete an ICON.  This code is in hack.icon.c.
  24.  
  25. 4) I have no earthly idea exactly how CurrentDir is to be called.  HACK
  26.    definitely leaves an extra lock laying around that connects to the
  27.    HACK_GAME: volume, but I am not exactly sure when it is safe to delete
  28.    that lock, nor what to do with the old lock that CurrentDir returns.
  29.    This code is in UnixXface.c.
  30.  
  31. 5) Register variables simply don't work.  Doio appears to trash D7 and 
  32.    consequently makes life miserable for the remainder of Hack.  Right
  33.    now I have a #define register in config.h, but you can change it to
  34.    #define register register   to see hack fail.
  35.  
  36. 6) Bitfields have proven to be fairly unreliable.  If you change the
  37.    definition of the Bitfield macro in config.h, you will see some very
  38.    strange behavior in the code (as well as a sizable increase in the
  39.    size)
  40.  
  41. 7) Hack is extremely large.  At 219K it takes a long time to link and 
  42.    would not link with the first version of ALINK.  I expect that if
  43.    many more enhancements are made, it will become too large to link
  44.    on a 512 machine.
  45.  
  46.  
  47. Organization:
  48.  
  49. HACK_SOURCE:   should be assigned to the logical disk containing the source.
  50. LATTICE_C:     should be assigned to a disk having an include directory with
  51.                ALL include files under it.  Only 4 programs use other than
  52.                the standard lattice include files.
  53. I:             should be assigned to the directory containg the lattice 
  54.                standard header files.
  55. HACK_GAME:     should be assigned to the disk containing the final image.
  56.                This disk should have a LIB directory of all the link
  57.                libraries.
  58. HACK_GAME:SAVED GAMES  This is where all the saved games are stored.
  59.  
  60. Important files:
  61. ccall          Recompiles all of HACK
  62. ccwindow       Recompiles hack.window.c
  63. ccicon         Recompiles hack.icon.c
  64. hack.window.c  All the Amiga I/O interface routines.
  65. hack.icon.c    All the Amiga ICON interface routines.
  66. UnixXface.c    The stub routines to allow hack to exist in a non-unix
  67.                environment.
  68.  
  69. You are welcome to distribute the Game disk to any one you wish, but 
  70. distribution of the source should be limited in order to preserve the
  71. integrity of HACK.  Everyone thinks they are a programmer, and it would
  72. be nice if there weren't 50 million different extensions to HACK, yet at
  73. the same time it would be nice to see some very usable features:
  74.      An option to cause all messages at the top of the screen to be spoken.
  75.      Sounds to accompany various actions (zapping a wand, hitting monsters)
  76.      A Hack character set for displaying the various monsters.
  77.      Better graphics in displaying the room - perhaps dual playfields with
  78.         one as the room and the other for the monsters.
  79.  
  80. Feel free to contact me if there are any questions.  If you like this and
  81. would like to see more freeware of this sort, please let me know.
  82.  
  83.   John A. Toebes, VIII
  84.   120-H Northington Place
  85.   Cary, NC, 27511
  86.   (919) 469-4120
  87.